home *** CD-ROM | disk | FTP | other *** search
/ Travel to Space / Travel to Space.iso / dos_prog / astronmy / sky15 / sky.doc < prev    next >
Text File  |  1990-12-03  |  10KB  |  333 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     S K Y
  13.  
  14.  
  15.  
  16.  
  17.                                  Version 1.5
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                 The Location of the Sun and Moon at any Time.
  28.  
  29.                     Their Rising and Setting on any Day.
  30.  
  31.  
  32.  
  33.  
  34.                                 DOCUMENTATION
  35.  
  36.  
  37.  
  38.  
  39.                                      by
  40.  
  41.  
  42.                                 Leonard Abbey
  43.  
  44.                                 CIS 72277,566
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                               November 26, 1990
  52.  
  53.                     Copyright (C) Leonard B. Abbey, 1990
  54.                              All Rights Reserved
  55.  
  56.  
  57.                           ABBEY INFORMATION SYSTEMS
  58.                              1002 Citadel Drive
  59.                            Atlanta, Georgia 30324
  60.  
  61.  
  62.    ABBEY INFORMATION SYSTEMS            SKY                               2.
  63.  
  64.  
  65.  
  66.                                 INTRODUCTION
  67.  
  68.  
  69.         SKY.EXE is descended from the famed TONITE.  It is specific
  70.         for the MS-DOS/OS-2 computer.  It is fast and flexible.  
  71.  
  72.         As with most programs of this kind, SKY.EXE came into
  73.         existence to fill the particular needs of the author, who is
  74.         a photographer.  This program may not meet the exacting
  75.         scholarly demands of professional astronomers, but it is
  76.         quick, easy to use, and it works.  
  77.  
  78.  
  79.  
  80.                                FILES PROVIDED
  81.  
  82.  
  83.         The following files are to be found in the self-extracting
  84.         archive, SKYARC.EXE:
  85.  
  86.              READ.ME        A descriptive file.  
  87.              SKY.DOC        Documentation for SKY.EXE
  88.              SKY.EXE        The SKY program itself.  
  89.  
  90.         If any of these files are missing, please contact the author.  
  91.  
  92.  
  93.  
  94.                         COPYRIGHT NOTICE AND LICENSE
  95.  
  96.  
  97.         SKY.EXE is a gift to you from the author, subject to the
  98.         terms of this license.  SKY.EXE is not in the public domain.  
  99.         It is not shareware.  This program, and its accompanying
  100.         documentation, are copyrighted under the laws of the United
  101.         States of America.  
  102.  
  103.         You are licensed to use this program for personal, non-
  104.         commercial, purposes. 
  105.  
  106.         You may not distribute SKY.EXE to others without the permis-
  107.         sion of the author.
  108.  
  109.  
  110.  
  111.                                   WARRANTY
  112.  
  113.  
  114.         This program, and it's accompanying documentation, is without
  115.         warranty, express or implied.  This includes warranties of
  116.         merchantability or suitability for intended purpose.  It is
  117.         supplied "as is."  The author will not be held liable for any
  118.         consequental damages.  
  119.  
  120.  
  121.  
  122.    ABBEY INFORMATION SYSTEMS            SKY                               3.  
  123.  
  124.  
  125.  
  126.         SKY.EXE is written for the IBM computers, and close clones.    
  127.         It requires a minimum of 256 K Random Access Memory to load
  128.         and run.  It will run with MS-DOS 2.11, however version 3.x
  129.         is recommended. 
  130.  
  131.         The program can be run from a floppy-disk drive or from a
  132.         hard disk.  
  133.  
  134.         SKY.EXE automatically recognizes and supports monochrome,
  135.         Hercules, CGA, EGA, Super EGA, and VGA graphics adapters.  
  136.         Snow checking is available through a command line switch.  
  137.  
  138.  
  139.  
  140.                             HOW THE PROGRAM WORKS
  141.  
  142.  
  143.         SKY.EXE prompts for input of the date, or dates, for which
  144.         information is desired.  It then calculates and displays
  145.         various combinations of the following data:
  146.  
  147.                 Times of Sunrise and Sunset
  148.                 Times of Moonrise and Moonset
  149.                 Age of the Moon in days
  150.                 Phase of the Moon
  151.                 Altitude and Azimuth of the Sun
  152.                 Altitude and Azimuth of the Moon
  153.                 Path of the Sun and Moon across the sky
  154.  
  155.  
  156.         Printouts of this information are provided if required.  If
  157.         desired, any of the calculations can be made for a range of
  158.         dates.  
  159.  
  160.  
  161.  
  162.                            INSTALLING THE PROGRAM
  163.  
  164.  
  165.         De-archiving the program.
  166.  
  167.         This program is supplied as a self-extracting archive, pro-
  168.         duced with the LHARC program.  To extract the files, merely
  169.         type "SKYARC" (without the quotation marks).  No other soft-
  170.         ware is required to perform the extraction.
  171.  
  172.  
  173.  
  174.    ABBEY INFORMATION SYSTEMS            SKY                               4.  
  175.  
  176.  
  177.  
  178.         Floppy Disk Installation.  
  179.  
  180.         Insert the floppy disk containing the program into the disk
  181.         drive.
  182.  
  183.  
  184.         Hard Disk Installation.
  185.  
  186.         Copy the all of the program files onto the hard disk.
  187.  
  188.  
  189.         Setup.  
  190.  
  191.         The program is able to determine its location on a hard disk.  
  192.         This allows it to be run from any sub-directory without
  193.         having to keep multiple CFG files.  This feature requires DOS
  194.         version 3.0 or later.  If your DOS version is earlier than
  195.         this, the program will function, but you will have to make
  196.         the directory in which it resides the default directory
  197.         before the program is run.
  198.  
  199.         When the program is first run, it searches it's own directory
  200.         for a configuration file, SKY.CFG.  If it does not find
  201.         this file it builds one, prompting the user for the required
  202.         information.  Be prepared to enter your latitude, longitude,
  203.         and time zone.  IF YOUR LOCATION IS IN THE UNITED STATES,
  204.         YOUR LONGITUDE IS NEGATIVE (-).  Approximate values are ade-
  205.         quate, because this is not a precision program.
  206.  
  207.         Daylight Savings Time is automatically adjusted for when
  208.         appropriate. You will be asked if your area observes this
  209.         perverse system.
  210.  
  211.         SKY allows you to customize the program for your printer.
  212.         Setup asks you for a printer number.  Values of 1 through 4
  213.         are accepted.  These correspond to ports LPT1 through LPT4.
  214.  
  215.         The number of lines per page for your printer can also be
  216.         specified.  This value must be greater than 11 because of the
  217.         space required for the margins and header.  If you specify a
  218.         number in this field, the printer will skip over the perfora-
  219.         tions at the end of each page, and will print a new header at
  220.         the top of each page.  If you specify a value of 0, the
  221.         printout will be continuous, with only one header (at the top
  222.         of the first page).
  223.  
  224.         SKY.EXE will automatically customize itself for your
  225.         monitor.
  226.  
  227.  
  228.    ABBEY INFORMATION SYSTEMS            SKY                               5.  
  229.  
  230.  
  231.  
  232.                                   OPERATION
  233.  
  234.  
  235.         Running the program.
  236.  
  237.         If the directory (or disk) which contains the program is in
  238.         the PATH, type "SKY" (without the quotation marks).  
  239.         Otherwise, move to the directory containing the program, and
  240.         type "SKY".
  241.  
  242.         The operation of the program is fully documented by help
  243.         screens.  These are available from any of the program screens
  244.         by pressing F1.  
  245.  
  246.         Definitions of the various quantities which are calculated,
  247.         and information on the daily motions of the Sun and Moon are
  248.         given on the definition screens, which are available by
  249.         pressing F3.
  250.  
  251.  
  252.         Command line switches.
  253.  
  254.         This version of SKY uses three command line switches.  They
  255.         are:
  256.  
  257.                 /C   (C)onfigure.  Forces reconfiguration of
  258.                      the program.
  259.  
  260.                 /M   (M)onochrome.  Optimizes the program
  261.                      for monochrome systems.  
  262.  
  263.                 /S   (S)now checking.  The program normally
  264.                      turns snow checking off for color
  265.                      systems.  This increases the program's
  266.                      speed.  Use this switch if you have a
  267.                      CGA monitor, and snow checking is
  268.                      required.  
  269.  
  270.  
  271.         To use a command line switch, run the program as follows:
  272.  
  273.                                   SKY /S
  274.  
  275.         The "C" (or "M", or "S") may be preceded by a "/", "-",
  276.         or a space (" ").
  277.  
  278.  
  279.    ABBEY INFORMATION SYSTEMS            SKY                               6.  
  280.  
  281.  
  282.  
  283.                                    SUPPORT
  284.  
  285.         In the unlikely event that support is required, the author
  286.         may be reached on CompuServe's ASTROFORUM, or at the follow-
  287.         ing address:
  288.  
  289.  
  290.                           Leonard B. Abbey
  291.                           1002 Citadel Drive
  292.                           Atlanta, Georgia  30324
  293.  
  294.                           404-633-7446
  295.  
  296.                           CIS # 72277,566
  297.  
  298.  
  299.         Comments and suggestions are welcome.
  300.  
  301.  
  302.  
  303.                                    CREDITS
  304.  
  305.  
  306.         SKY.EXE was written with Microsoft Professional Development
  307.         System, Version 7.  It employs extensive assembly language
  308.         subroutines from MicroHelp's Mach 2 and QB/Pro libraries.  
  309.  
  310.         The suggestions and comments of Richard Hess were invaluable
  311.         in the preparation of Version 1.4.  
  312.  
  313.  
  314.  
  315.  
  316.                                    HISTORY
  317.  
  318.  
  319.         Version 1.0  June 10, 1990        -  Original release.  
  320.         Version 1.1  July 6, 1990         -  Fixed minor bugs
  321.                                              and typos.
  322.         Version 1.2  July 14, 1990        -  Fixed problem with dates
  323.                                              on long runs.
  324.         Version 1.3  August 26, 1990      -  Added print to file for
  325.                                              Path and printer
  326.                                              options.
  327.         Version 1.4 October 29, 1990      -  Atlantic time zone
  328.                                              added. Minor bug fix.     
  329.         Version 1.5 November 26, 1990     -  Minor bug fix.
  330.  
  331.  
  332.  
  333.